SetInputTextType

Availability

Flash Lite 1.1.

Description

Specifies the mode in which the input text field should be opened:

Command	Parameters	Value returned
`"SetInputTextType"`	`variableName` Name of the input text field. It can be either the name of a variable or a string value that contains the name of a variable. `type` One of the values `Numeric`, `Alpha`, `Alphanumeric`, `Latin`, `NonLatin`, or `NoRestriction`.	0: Failure. 1: Success.

Command

Parameters

Value returned

"SetInputTextType"

variableName Name of the input text field. It can be either the name of a variable or a string value that contains the name of a variable.

type One of the values Numeric, Alpha, Alphanumeric, Latin, NonLatin, or NoRestriction.

0: Failure.

1: Success.

Flash Lite supports input text functionality by asking the host application to start the generic device-specific text input interface, often referred to as the front-end processor (FEP). When the SetInputTextType command is not used, the FEP is opened in default mode.

The following table shows what effect each mode has, and what modes are substituted:

Mode specified	Sets the FEP to one of these mutually exclusive modes	If not supported on current device, opens the FEP in this mode
Numeric	Numbers only (0 to 9)	Alphanumeric
Alpha	Alphabetic characters only (A to Z, a to z)	Alphanumeric
Alphanumeric	Alphanumeric characters only (0 to 9, A to Z, a to z)	Latin
Latin	Latin characters only (alphanumeric and punctuation)	NoRestriction
NonLatin	Non-Latin characters only (for example, Kanji and Kana)	NoRestriction
NoRestriction	Default mode (sets no restriction on the FEP)

NOTE

Not all mobile phones support these input text field types. For this reason, you must validate the input text data.

Example

The following line of code sets the input text type of the field associated with the input1 variable to receive numeric data:

status = fscommand2("SetInputTextType", "input1", "Numeric");

View comments on LiveDocs